home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / r / rexx_plus_compiler / rexxpluscompiler2.dms / in.adf / screenshare / screenshare.zoo / readme < prev    next >
Encoding:
Text File  |  1991-07-21  |  3.5 KB  |  64 lines
  1.  
  2.     screenshare.library
  3.     ===================
  4.  
  5.     This is a proposed scheme to allow applications ("symbionts") to
  6. open up windows on other applications' ("hosts") custom screens.
  7.     There are many reasons for wanting to do this. For example, it is
  8. nice to be able to have AmigaREXX open up a file requester on your
  9. application's screen from outside of your application, and it is useful to
  10. be able to open up your editor on your terminal emulator's screen so you
  11. can write your messages while being able to see the contents of the
  12. terminal's screen. Sofar, this has only been possible by opening all
  13. applications on the Workbench. This causes excessive clutter, and limits
  14. you to the Workbench's number of colors and resolution mode.
  15.     The scheme proposed here consists of an exec library to which
  16. prospective hosts can post their screen pointers and provide them with a
  17. unique name.  Symbionts can query the same library and find, given the name,
  18. the pointer to the host's screen. The method is very simple, does not
  19. require SetFunction()ing any Amiga functions, does not take up very much
  20. room, is trivially easy to implement, and is, above all, safe if both hosts
  21. and symbionts obey the rules.  This implies, however, that the method
  22. cannot be used transparently with existing applications not set up properly.
  23. This is just as well, because any scheme that tries to retrofit screen
  24. sharing to older applications requires trickery and is dangerous.
  25.     There are six accessible functions in the screenshare.library, one of
  26. which is mainly a debugging tool and should not normally be called in an
  27. application. A typical host would call the functions: PublicScreen() to declare
  28. a screen public, PubScrLocked() to inquire whether there are any symbionts
  29. currently accessing the screen, and PrivateScreen() to revert a named public
  30. screen to private status. A typical symbiont would call the functions:
  31. LockPubScreen() to obtain a pointer to the Screen structure of a named public
  32. screen, and UnlockPubScreen() to signal to the library that all windows on a
  33. named public screen have been closed by the symbiont. All calls have a single
  34. argument, the name of the public screen (a null-terminated ascii string), with 
  35. the exception of PublicScreen(), which has a pointer to the Screen structure
  36. as the second argument.
  37.     It is possible for a program to be both a host and a symbiont, e.g. 
  38. when the first instance of a program opens a screen, and subsequent instances
  39. want to open on that same screen.
  40.     Further documentation can be found in the file pubscr.c, the main
  41. part of the screenshare.library.
  42.     The functions can be accessed by linking the glue routines contained
  43. in liblink.asm to your host or symbiont.
  44.  
  45.     In this archive, you will find also three utilities: showscr, addscr, 
  46. and addsym. Thes are intended for debugging purposes only, and should typically
  47. not be distributed with your software. Showscr shows the current list of 
  48. shared screens. Addscr can fake a shared screen by adding one to the list. It
  49. can also remove shared screens from the list. Addsym can fake a symbiont 
  50. opening up on a shared screen. It can also remove symbionts.
  51.  
  52.     These files are not in the public domain. They may, however, be
  53. distributed freely, and used freely, in any software, PD or commercial.
  54.  
  55.     Willy Langeveld            11 may 1988
  56.  
  57.  
  58.  
  59.     For this release: the documentation did not state previously that
  60. int return codes from functions are 16 bit values and should more properly
  61. be called short. Also, a minor bug was fixed.
  62.  
  63.     Willy Langeveld            7 september 1989
  64.